home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / rtextu10.zip / UPCASE.DOC < prev    next >
Text File  |  1993-05-06  |  4KB  |  85 lines
  1.  
  2.  
  3.                 #     #          #####                         
  4.                 #     #  #####  #     #    ##     ####   ######
  5.                 #     #  #    # #         #  #   #       #     
  6.                 #     #  #    # #        #    #   ####   ##### 
  7.                 #     #  #####  #        ######       #  #     
  8.                 #     #  #      #     #  #    #  #    #  #     
  9.                  #####   #       #####   #    #   ####   ######
  10.  
  11.  
  12.  
  13.  
  14. You can get part of the following documentation by invoking the program with
  15. the switches -v, -h, or -H . See README.TXT for more information.
  16.  
  17. -----------------------------------   -v   ------------------------------------
  18. UPCASE v1.0 -- Change characters in several files to upper case
  19. Copr (c) 1992,1993 Richard Breuer. UPCASE is freeware. No warranties.
  20.  
  21. This is UPCASE/2 v1.0 - renamed to UPCASE (from RUTILS 4).
  22.  
  23. Author: Richard Breuer
  24.         Brunssumstrasse 6
  25.         5100 Aachen
  26.         (after Jul 1, 1993: 52074 Aachen)
  27.         Germany
  28.         Europe
  29.  
  30. Phone:  +49/241/85605
  31. Fax:    +49/241/8021329
  32.  
  33. Email:  ricki@pool.informatik.rwth-aachen.de (Preferred!)
  34.  
  35. -----------------------------------   -h   ------------------------------------
  36. UPCASE v1.0 -- Change characters in several files to upper case
  37. Copr (c) 1992,1993 Richard Breuer. UPCASE is freeware. No warranties.
  38.  
  39. Usage:
  40.    UPCASE [-b:e:hHrv*] infile.. [{>|>>} outfile]
  41.  
  42. Options:
  43.    -b<n>  The translation begins at column n. If n is 0 or negative, it is
  44.           computed to length(line)-n. Default is n=1
  45.    -e<n>  The translation ends at column n. If n is 0 or negative, it is
  46.           computed to length(line)-n. Default is n=0
  47.    -h     Display this help screen
  48.    -H     Display another help screen with notes and examples
  49.    -r     Respect quotes. If -r is specified together with -b or -e, only
  50.           quotes in the given range are respected. Quotes are <'> and <">
  51.    -v     Display version info and information about the author
  52.    -*     Display internal information (for debugging purposes)
  53.  
  54. -----------------------------------   -H   ------------------------------------
  55. UPCASE v1.0 -- Change characters in several files to upper case
  56. Copr (c) 1992,1993 Richard Breuer. UPCASE is freeware. No warranties.
  57. Notes:
  58.    UPCASE reads from stdin if a filename is -. The output is always directed
  59.    to stdout. The line lengths are restricted to 255 characters. Longer lines
  60.    will be cut. The errorlevel is set to 1 if help has been displayed. It is
  61.    set to 255 in case of an error and 0 on normal completion. Output resulting
  62.    from multiple input files is appended to stdout. The processing order for
  63.    wildcards depends on the order of the directory entries. UPCASE returns
  64.    nonsense for binary files.
  65.  
  66. Examples:
  67.    UPCASE *.TXT
  68.       Change all *.TXT files in the current directory to upper case and append
  69.       them to stdout. The order is the one DOS's dir tells you.
  70.    DIR | UPCASE
  71.       Displays the directory in upper case letters.
  72.    UPCASE HEADER.TXT - FOOTER.TXT
  73.       After processing HEADER.TXT the user must input text from the keyboard
  74.       until Ctrl/Z (=EOF) is detected. Then FOOTER.TXT is processed. All output
  75.       is appended on stdout.
  76.    UPCASE MYPROG.PAS -r
  77.       Translate MYPROG.PAS, but don't change the quoted strings.
  78.  
  79. -------------------------------------------------------------------------------
  80. Additional information:
  81.    UPCASE is one more lower-to-upper case converter. What makes it useful to
  82.    me (and maybe U 2), is the -r option which ensures that UPCASE does not
  83.    change the case of strings enclosed in <'> or <">. This makes it useful
  84.    for source code.
  85.